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My Journey? 

25 years IT programming and design 

FORTRAN->C->C++->Java->C#->Ruby 

Unix->VMS->DOS->Windows->Linux 

6a->SCJP->RHCE->GSEC->CISSP 

Violin->Clarinet->Piano->Voice 

American->Cheddar->Muenster->Jarlsberg 
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Our Journey? 

Scope and Preconditions 

Project: Directories and Files 
Activity LifecycleBB i 

Lifecycle Methods 

UlTnpift 

State 

Testing, Debugging and Uploading 

Q&A 
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What is "Android" 



F 



"Android is a software stack for mobile 
devices that includes an operating system, 
middleware and key applications. The Android 
SDK provides the tools and APIs necessary 
to begin developing applications on the 
Android platform using the Java programming 
language." 




http://developer.android.com/guide/basics/what-is-android.html 
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Geekic Overlook 







Although the Java syntax is used 
and Java bytecode serves as an 
input for creating an Android application, 
the actual runtime environment is the 
Dalvik VM which does not support all the 
standard Java behaviors or libraries (like 
Swing) 

Geek points: Standard JVMs use a stack, 
the Delvik VM is register-based 
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Scope 



Android Activity 

- Usually programs for human interaction 

- Separate from services and broadcast 

receivers 

Introductory 

- Even though we have an hour or two, we 

won't explore every feature available or 
even half, quarter, eighth, ... 

Interactive 

- Ask questions, participate 
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The Sample Application 
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Preconditions 



Install Java 6 
Install Android SDK 

- latest is 3.0 as of 4/21/2011 

Unless you abhor productivity 
improvements, install Eclipse and the 
ADT plug-in 

Learn Java 
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Our Journey? 

Scope and Preconditions 
Project: Directories and Files 

Activity Lifecycle M ^ 

Lifecycle Methods 

UlTnpift 

State 
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Project: Directory and Files 






Sequence 



D- e3 9 en [Generated Java Files] 
[> a& Android 2.2 

E3? assets 
J §3? res 

t- &> drawable-hdpi 
r> S" drawable-ldpi 
[> (^ drawable-mdpi 
[> (S? layout 
[> i23> menu 
[> Q3> values 

An d ro i d M a n if est.xm I 
d ef a u It. prop erti es 
=j proguard.cfg 



Project 
src 
gen 
assets 



res 



- drawable-hdpi 

- drawable-mdpi 

- drawable-ldpi 

- layout 

- menu 

- values 
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File: AndroidManifest.xml 

• Configuration for the application 

• Versioning, icon, initialization 

<manif est package=" com . monead . games . android. sequence" 
android: versionName="01 .06" android: versionCode=" 17" > 
<application android: icon="@drawable/launch_seq" 
android:label="@string/titl e_app_n ame " > 
<activity android: name=" . Sequence" 
android: label="@string/title_app_name"> 
<intent-f ilter> . . . </intent-f ilter> 
</activity> 
</application> 
<uses-sdk android: targetSdkVersion="8" 

android : minSdkVersion= " 4 " > 
</uses-sdk> 
</manif est> 



^ 
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Directory: src 



Application source code 
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4 yl Sequence 
a £9 src 




a corn. rnonead.garnes.android. sequence 
t> JJ| Ap p Vi ew.j ava 
t> JT| B utto nVi ew.j ava 




[> JT) ColorChoiceListener.java 




[> \T\ Model.java 
t> JJ| Sequence.java 
t> \S] SetupView.java 




a com.monead.garnes.andrcid.sequence.&hape 




\J] DiarnondShape.java 
[> [T| TriangleShape.java 
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Directory: res/drawable-* 

Image files 

3 directories to deal with various screen 
resolutions 

ldpi->low, mdpi->medium, hdpi->high 

Syntax to load an image allows the 
environment to determine the correct 
directory (Idpi, mdpi, hdpi) 

Image file name must match in each 
directory so that it can be found 
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Example of Launcher Icon File 

• 3 resolutions for icon (measured in pixels): 
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• Idpi- 


>3 


fixe 

***** 

••• 
* ••* 
i *** 


16, mdpi->48x48, hdpi->72x72 

^ IS? drawable-hdpi 

Ai ic_launcher_sequence.pncj 

Eh icon.png 
a l23 drawable-ldpi 

Ai ic_launcher_sequence.png 

Ife icon.png 
j & drawable-mdpi 

% ic_launcher_sec|uen-:e.pny 

Hi icon.png 

^ r"^ 1 .0. 
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Directory: res/layout 
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Ul definitions 

Layouts 

Widgets 



a £? layout 




|Xj main.xml 
Q setup.xml 
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Directory: res/menu 



Defines menus accessible to the user 



Packag 



£3 



B% 



O HelloAndroid 
t°7 LunarLander 
V§ Sequence 

^5 gen [Generated Java Files] 
& Android 2.2 
& assets. 
&res 

& drawable-hdpi 

& drawable-ldpi 

Q^? drawable-mdpi 

& layout 

£> menu 

[x] gamejnenu.xrnl 

& values 
[Q; Android Man if est.xrn I 
[B) default. properties 
Pfcj ic_launcher_sequence_copy, 

proguard.cfg 
Q SequeneeTest 
Q Snake 



game_menu.xml * ^J Android Ma nifest.xm I 
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K?xml version="l . 0" encoding="utf-8"?> 

2 <menu xmlns : android="http : / / schemas . android . 

3 <item android: id =l, @+id/help" 

4 android: title= ,T @string/help" /> 

5 <item android: id="@+id/setup" 

6 android: title= ,T @ string/setup" /> 
<item android: id="@+id/new_game" 

8 android: title =,I @string/new_game' T / 

9 <item android: id="@+id/quit" 

10 android: title="@string/quit" /> 

11 <item android: id="@+id/about" 

12 android: title="@string/about" /> 

13 <item android: id="@+id/stats" 
1 a 



H 



anrlrni H ■ ~t~ ~i ~l~ 1 g»= lt fle;'t~r''~i nrr i c:+- 3+- 
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Directory: res/values 

Constants, supports internationalization 



Packag 



B% 



Q HelloAndroid 
Q LunarLander 
jj5 Sequence 
£§src 

£§ gen [Generated Java Files] 
Bi Android 2.2 
^ assets 
lb res 

(23> drawable-hdpi 
Q5? drawable-ldpi 
Q5? drawable-mdpi 
O? layout 
O? menu 
£5^ values 

[xj strings.xml 
iO, AndroidManifest.xml 
|jj default. properties 
jlh| ic_launcher_sequence_copy, 
proguard.cfg 
Q SequenceTest 
Q Snake 



^game_menu.xml strings.xml 



£3 



l<?xml version="l . 0" encoding="utf-8"?> 
2 <resources> 



<string narne= 
<string name= 
<string narne= 
<string name= 
<string name= 
<string name= 
<string name= 
<string name= 
<string name= 

12 </resources> 

13 



"hello">Hello World, Sequer 

"app_name">Sequence Hunt</£ 

" setup ">Setup</string> 

"help">Help</string> 

"new_game">New Game</strinc 

"quit">Quit</string> 

" about ">About</string> 

" st at s " >St at istics</ string; 

"debug ">Debug Info</string; 
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Our Journey? 

Scope and Preconditions 
Project: Directories and Files 
Activity Lifecycle 
Lifecycle Methods 

UlTnpift 

State 

Testing, Debugging and Uploading 

Q&A 
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Activity Lifecycle 

Guaranteed set of states through which 
the activity will pass from initial launch to 
termination 

Programmatically represented with 
methods that the programmer overrides 
to control the activity when it is in a 
specific state 

An activity implementation is a class that 
extends android. app. Activity 
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Activity Lifecycle Depiction 
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User navigates 

back to the 

sr.'.vi-r/ 



Process is 
Hilled 
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oiRestarti) 



(Activity is ^\ 
running J 



The activity 

comes to \he 

/nfp-drrtjjr^ 



0QJQI5 
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Another activity comes 
in front of the activity 



Other applications] 
need memory 



(Activity is ^ 
shutdown J 
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The activity 

comes to trie 

foreground 
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Our Journey? 

Scope and Preconditions 
Project: Directories and Files 
Activity LifecyclejB i 

Lifecycle Methods 

UlTnpift 

State 

Testing, Debugging and Uploading 

Q&A 
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Activity Lifecycle Methods 

void onCreate(Bundle savedlnstanceState) 

void onStart() 

void onRestart() 

void onResumeO 

void onPause() 

void onStop() 

void onDestroy() 
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onCreate(Bundle savedState) 



// Called at Activity instance creation 

SOverride 

protected void onCreate (Bundle savedState) 

super . onCreate (savedState) ; 

gameBoard = new SequenceGameBoard (this) ; 

loadModel () ; 

gameBoard. setOnTouchListener (this) ; 

if (firstUseO) { 

setupForFirstUse () ; 

} else { 

displayGameboard ( ) ; 



} 



} 



: 
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onPauseQ 



// Called by environment if the 

// app loses foreground control 

@Override 

protected void onPause() { 

super . onPause ( ) ; 

setGameBoardNotVisible () ; 

saveModel ( ) ; 

saveGameStatistics () ; 

} 
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onResumeQ 



// Called when an existing app 
// instance regains fg control 
@Override 

void onResume() { 
. onResume ( ) ; 
loadModel () ; 
} 
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Explore Some Source Code 

We'll switch to Eclipse and look at an 
Activity using some lifecycle methods 
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Our Journey? 

Scope and Preconditions 
Project: Directories and Files 
Activity LifecycleBB i 

Lifecycle Methods 

UlTnpift 

State 

Testing, Debugging and Uploading 

Q&A 
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Ul View 
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Preferred approach to define the Ul is to 
use XML files located in the res/layout 
directory 

Using the Eclipse plugin for Android 
development simplifies the development 
cycle since there is a build step required 
to turn the Ul definitions into code so that 
you may programmatically access the 
widgets defined in the XML file 
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Simple Layout 



<!-- res/layout/help . xml --> 

<?xml version="l . 0" encoding="utf-8 ,, ?> 

<RelativeLayout 

android: id="@+id/screen" 
android: layout_width="f ill_parent" 
android: layout_height=" f ill_parent" 
android: f ocusable="true"> 
<TextView . . . > 
<Button android: id="@+id/button_close" 

android: layout_width =,, wrap_content" 
android: layout_height="wrap_content" 
android: text=" @ string/but ton_close" /> 
<WebView android: id="@+id/ instructions" 

android: layout_width="match_parent" 
android: layout_height =,, match_parent" /> 
</RelativeLayout> 



^ 
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Code Using the Prior Ul (partial) 

// This method is in the Activity class 
private void showHelpScreen ( ) { 

String url; ■ 

setContentView (R . layout . help) ; 

url = "file: ///android_asset/help/in .html" ; 
WebView instructions = (WebView) 

f indViewByld (R. id. Instructions) ; 
instructions . loadUrl (url) ; 
( (Button) f indViewBy Id (R. id. button_close) ) 

. setOnClickListener (helpDoneClick) ; 

} 
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Resulting Screen 



URD@ 8:54 




Objective 



Sequence Hunt requires the player to 
figure out a sequence of colors. Each 
attempt to guess the sequence is called 

a try. There are four to eight (selected 
by the user) positions and each position 
may have any one of six colors in it 

(Black, Blue r Green, Red, White or 
Yellow). A color may appear more than 
once and obviously not all the colors will 
be used in a given sequence. 

The game allows up to 10 trys to find the 
sequence. Each try is represented as a 
row of circles. In response to a try, the 
player is provided with clues to help 



: 




(Nota di traduzione:.. Mi scuso per 
eventuali errori di grammatica non sono 
un madrelingua di questo linguaggio cosi 
ho invocato un programma di traduzione 
Se hai suggerito miglioramenti per le 
parole e la grammatica del gioco, Le 
sarei grato di farmelo sapere. Grazie.) 



Obiettivo 



Sequence Hunt richiede al giocatore di 
capire una sequenza di colori, Ogni 
tentative di indovinare la sequenza viene 
chiamata una prova. Ci sono 4-8 

(selezionato dall'utente) le posizioni e 
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Layout with Multiple Widgets 

<!-- res/layout/setup . xml --> 

<LinearLayout ... android: orientation="vertical"> 
<TextView android: id="@+id/label" ... /> 
<RadioGroup . . .> 

<RadioButton android: id="@+id/radio_easy" 

android: text="Easy" /> 
<RadioButton android: id="@+id/radio_hard" 
android: text="Hard" /> 
</RadioGroup> 
<LinearLayout ... android: orientation="horizontal" 
<Button android: id="@+id/button_save" ... 

android: text="Save" /> 
<Button android: id="@+id/button_cancel" ... 
android: text="Cancel" /> 
</ Linear Layout > 
</ Linear Layout > 



^ 
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Code Using Prior Ul (partial) 



private void setupScreen ( ) { 

^^ setContentView (R . layout . setup) ; 

RadioButton easy = (RadioButton) 

findViewBy Id (R. id. radio_easy) ; 
RadioButton hard = (RadioButton) 

f indViewBy Id (R. id. rad±o_hard) ; 
( (Button) 

f indViewByld (R. id. button_save) ) 
. setOnClickListener (setupSave) ; 
easy . setChecked (true) ; 



} 
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Resulting Screen 
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Programmatic Ul 
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Can define the view by extending the 
android.view.View class 

Override the onDraw(Canvas canvas) 

method 

Receives a Canvas instance, which 
represents the screen ™ 

Use invalidate() method to force the view 
to redraw itself on the device 
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Drawing on the Canvas 

ShapeDrawable drawable ; 
i drawable = new ShapeDrawable ( 

new RectShape () ) ; 
drawable . getPaint ( ) 

. setColor (Color . CYAN) ; 
drawable . setBounds (0,0, getWidth ( ) , 10) ; 
drawable . draw (canvas) ; 
drawable . getPaint ( ) 

. setColor (Color . YELLOW) ; 
drawable . setBounds (0, 11, getWidth ( ) ,20) ; 
drawable . draw (canvas) ; 
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Creating Your Own Shapes 

Extend 

android. graphics. drawable. shapes. Shape 
Override the draw() method 

- You are given Canvas and Paint instances 

android. graphics.Path class is handy for 

connecting a set of line segments Nmh 
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Drawing a Diamond 

@Override 

public void draw (Canvas canvas, 
Paint paint) { 

Path path; 

path = new Path(); 

path .moveTo (getWidth 0/2, ) ; 

path . lineTo (0, getHeight ( ) /2) ; 

path . lineTo (getWidth ( ) /2 , getHeight ( ) ) ; 

path .lineTo (getWidth ( ) , ^^m 

getHeight () /2) ; ^™ 

path. lineTo (getWidth () /2 r 0) ; 

canvas . drawPath (path, paint) ; 



i* 
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Resulting Shape 
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Menu 



Defined as XML resource 
Lifecycle methods in Activity 

- onCreateOptionsMenu(Menu m) 

- onOptionsMenuSelected(Menultem mi) 



^ 
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Game Menu Definition 



<!-- res/menu/game_menu . xml --> 

<?xml version="l . 0" encoding="utf-8"?> 

<menu xmlns : android= 

"http : // schema s . android. com/ apk/ res/ android" > 

<item android : id=" @+id/how_to_j?lay " 

android: title= 

"@ string /menu_how_to_pl ay "></item> 
<item android: id="@+id/ setup" 
android: title= 

"@ string /menu_set up "></item> 
</menu> 



^ 
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onCreateOptionsMenuQ 



@Override 

public boolean onCreateOptionsMenu ( 
Menu menu) { ■ 

Menulnf later inf later = getMenuInf later () ; 

inf later . inflate (R.menu . game_menu, menu) ; 

return true; 

} 




^ 
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Menu Screenshot 



llfi 6:33 





onOptionsltemSelectedQ 



@Override 

public boolean onOptionsItemSelected ( 

Menultem item) { ■ 

switch (item. getltemld ( ) ) { 
case R. id. how_to_pl ay: 
showHelpScreen ( ) ; 
return true; 
default: 

return super . onOptionsItemSelected (item) ; 



j 



} 



} 
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Dialog 



Typical modal dialog for forcing an 
interaction 

- Notifying the user 

- Choosing configuration options 

Default view allows scrollable text area 
and a close button 



^ 
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Dialog Lifecycle Methods 



onCreateDialog(int id) 

- Used to setup the dialog's structure and 

events (buttons and listeners) 

onPrepareDialog(int id, Dialog d, Bundle b) 

- Used to set runtime information each time 

the dialog is shown. 

- Pre-version 8 (prior to Android 2.2) 

• onPrepareDialog(int id, Dialog d) 



<V 
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onCreateDialog() Example 



@Override 

protected Dialog onCreateDialog (int id) { 
AlertDialog .Builder builder; Dialog dialog; 
switch (id) { case DIALOG_INFO: 

builder = new AlertDialog. Builder (this) ; 
builder . setMessage ("The Message") . 
setCancelable (true) . setNeutralButton ("No", 
new Dialoglnterf ace . OnClickListener ( ) { 
public void onClick (Dialoglnterf ace 

Dialog, int id) { dialog. cancel () ; }}); 
dialog = builder . create () ; break; 
} return dialog; 
} 
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onPrepareDialog() Example 



@Override 

protected void onPrepareDialog (int id, 
Dialog dialog, Bundle bundle) { ■ 
switch (id) { 

case DIALOG_INFO: 

StringBuffer info = new StringBuf fer ( ) ; 
for (String detail : gameBd. getRtlnf o ( ) ) { 
info . append (detail) ; 

} ™ 

( (AlertDialog) dialog) 

. setMessage (info . toString ( ) ) ; break; 



^ 
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onPrepareDialog() Backward 

Compatibility 

SOverride 

protected void onPrepareDialog ( 

int id, Dialog dialog) { ■ 

if (android. os. Build. VERSION. SDK_INT < 8) { 

onPrepareDialog (id, dialog, null) ; 



} 



} 



^ 
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Dialog Screenshot 



BUD® 6:37 m 
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Sequence Hum 



Game Statistics 

Total Games: 12 

Games Won: 8 

Games Lost: 4 

Games Quit: 

Easy Games: 12 

Hard Games: 

Average Tries/Game: 6 

Average Time/Games Won: 

00:00:25 

Average Time/Games Lost: 

00:00:20 

Tntal Trip*v 7 A 



* rill I 18*3 



Spielstatistik 

Spiele Gesamt: 
Gewonnene Spiele: 
Spiele Verlieren: 
Spiele Gab: 
Einfaches Spiel: 
Schwierige Spiele: 
Durchschnittliche Versuche/ 
Spiele: 

Durchschnittliche Zeit/ 
Gewonnene Spiele: 00:00:00 
Durchschnittliche Zeit/Spiele 





Schlieften 
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Internationalization 

Define strings in a resource file 
Directory determines language 

- res/values : default 

- res/values-LANGUAGE 

- res/values-LANGUAGE_COUNTRY 

Examples 

- res/values-es/strings.xml 

- res/values-es_MX/strings.xml 



^ 
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res/values/strings.xm 



<?xml version="l . 0" encoding= n utf-8"?> 

<! — en — > 

<resources> 

<string name="title_app_name n > 
Sequence Hunt</string> 

<string name="title_welcome n > 

Welcome to Sequence Hunt ! </string> 

<string name= n title_how_to_play"> 

^* Instructions for Game Play</string> 
</resources> 



^ 
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res/values-de/strings.xml 



<?xml version="l . 0" encoding="utf-8"?> 

<! — de — > 

<resources> 

<string name="title_app_name n > 
Sequence Hunt</string> 

<string name="title_welcome n > 

Willkommen in Sequence Hunt ! </string> 

<string name= n title_how_to_play"> ^^^ 

^^ Anleitung fiir das Spiel</string> hnHH| 
</resources> 
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Get a Value - In A View 



<?xml version="l . 0" encoding="utf-8"?> 
<LinearLayout . . . > 

<TextView android: id="@+id/ label" 

android: text="@string/title_welcome" /> 
<ScrollView . . . XLinearLayout . . . > 
<TextView 

android: id="@+id/welcome_message_initial" 
android: text="@string/title_welcome"/> 
</ Linear Layout> </ScrollView> 
</ Linear Layout> 



^ 
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Get a Value - Programatically 



k. 



( (AlertDialog) dialog) . setMessage ( 

getResources ( ) . getString ( 
R . string . message_w±n) 

+ String . format ( 

getResources ( ) . getString ( 
R . string . message_play±ng_t±me) , 
Formatter . getlnstance ( ) . f ormatTimer ( 

gameBoard. getModel () . getElapsedTime () ) ) 

+ getResources () .getString ( 

R. string. quest±on_play_aga±n) ) ; 



^ 
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Project: Directories and Files 
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Ul Input 



Typical input sources 

- Keyboard 

- Touch Screen 

Event-based Paradigm 

- Register to listen for device events 



^ 
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Keyboard 



Could be physical or virtual 

- No difference for developer 

Activity will receive the events using 
callback methods 

- Override to process input 

• onKeyDown() 

• onKeyUp() 

• onKeyl_ongPress() 

• onKeyMultiple() 



J 
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onKeyDownQ Example 



@Override 

public boolean onKeyDown (int code, KeyEvent evt) { 
if (code == KeyEvent. KEYCODE_ENTER) { 

gameBoard. notif yTry ( ) ; 
} else if (code == KeyEvent . KEYCODE_DEL) 

gameBoard. notif yDeleteChoice () ; 
} else { 

return super . onKeyDown ( code , evt ) ; 

} 

return true; 



^ 
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Touch Screen Input 



k. 



Must implement an interface 

- android. view. View.OnTouchListener 

Declares one method 

- onTouch(View v, MotionEvent event) 

Register to receive touch events 
Method defined on View class 

- setOnTouchl_istener(OnTouchl_istener I) 



^ 
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onTouchQ Example in Activity 



@Override 

public boolean onTouch (View v, MotionEvent evt) 
boolean p; 

if (v instanceof OnTouchListener) { 

p = ( (OnTouchListener) v) . onTouch (v, evt); 

if (P) { 

if (gameBd. getModel ( ) . isWinner ( ) ) { 
showDialog (DIALOG_WIN) ; 

} 
} 
return true; 

} 

return false; 



k. 
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Motion Events 
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How was the screen touched 

Constants for decoding the events through 
the lifecycle of a gesture 

Examples 

- ACTION_DOWN 

- ACTION_MOVE 

- ACTIONJJP 
-ACTION CANCEL 
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onTouchQ Using Motion Event 



public boolean onTouch (View view, 
MotionEvent event) { 
if (event . getAction ( ) == 

MotionEvent . ACTION_DOWN) { 
processLocation (event . getX ( ) , 

event . getY ( ) ) ; 
invalidate ( ) ; 
return true; 

} Wm 

return false; 



^ 
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Our Journey? 

Scope and Preconditions 
Project: Directories and Files 
Activity LifecycleBB i 

Lifecycle Methods 

UlTnpift 
State 

Testing, Debugging and Uploading 
Q&A 
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Persisting State 

Shared Preferences 

- Store primitive data in key-value pairs 
Internal Storage 

- Store arbitrary data on the device memory 
External Storage 

- Store data on shared external storage 
SQLite Databases 

- Store structured data in a private database 
Network Connection 

- Store data on network-accessible device 



^ 
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Shared Preferences 
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Simple key-value pairs 

getSharedPreferences() available on the 
Activity class (inherited from Context) 

Supply a file name and a privacy mode 

for data visibility 

- MODE_PRIVATE 

- MODE_WORLD_READABLE 

- MODE WORLD WRITEABLE 



^ 
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Setting Shared Preferences Value 







SharedPref erences settings = 

s( 

"Sequence .preferences''', 

MODE_PRIVATE) ; 
SharedPref erences .Editor editor 

settings . edit ( ) ; 
editor . putBoolean ( "ModeHard" , 

true) ; 
editor . commit ( ) ; 



J 
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Getting Shared Preferences Value 







SharedPref erences settings 

s( 

"Sequence .preferences''', 
MODE_PRIVATE) ; 

someBean . setModeHard ( 

settings . getBoolean ( 
"ModeHard", false)); 



^ 
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Internal Storage 



k. 



Files associated with application 

You may expose files to other applications 

openFilelnputQ, openFileOutputQ 

available on the Activity instance 
(inherited from Context) 

Just like SharedPreferences, you supply a 
file name and, for output, a privacy 
mode 



j 
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Write to an Internal File 

ObjectOutputStream out = null; 
try { 

out = new 

Ob j ectOutputStream ( 

openFileOutput ("SeqModel .ser" r 
MODE_PRIVATE) ) ; 
out . writeObject (someBean . getModel ( ) ) ; 

} 
finally { 

if (out != null) { 
out . close ( ) ; 



} 



} 



: 
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Read from an Internal File 

ObjectlnputStream in = null; 
try { 

in = new ObjectlnputStream ( 

openFilelnput ("SeqModel . ser") ) ; 

Model model = (Model) in . readObject ( ) ; 

} 
finally { 

if (in != null) { 



in . close ( ) ; 



} 



} 



^ 
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Our Journey? 

Scope and Preconditions 
Project: Directories and Files 
Activity LifecycleBB i 

Lifecycle Methods 

UlTnpift 

State 

Testing, Debugging and Uploading 

Q&A 
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k. 



Testing 

The Android SDK provides emulators that 
can mimic a variety of Android versions, 
screen dimensions and phone behaviors 

Runs slower than on a real phone 

- So don't get too worried if your application 
feels sluggish in the emulator 

Provides support for all the features and 
lifecycle events including persisting 
state, writing local files, etc 

From Eclipse it launches automatically 
when you run the application 



^ 
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5554:my_avd 



Emulator at Startup 



SlDll 5:57i 



Google 



Rearrange your Home screen. 

To uch & hold an item and when a 
vibrates, drag it where yo j want. 







© © 
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Emulator Running an App 





k. 



Debugging 

Eclipse debug view is helpful 

- Can debug using phone or emulator 

Use of logging is essential 

Environment provides a logger accessed 
with the Log class' static methods: 

- v(), d(), i(), w(), e() 

- Two or three parameters: an application 

"tag" identifying the source of the 
message, a text message and an 
optional Throwable 
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Sample Code with Logging 

try { 

Packagelnfo pi = GetPackageManager ( ) 

. getPackagelnf o ( 

"com.monead. games . android. sequence" , 
progName = getPackageManager ( ) 

. getApplicationLabel ( 

getApplicationlnf o ( ) ) . toString ( ) ; 
progVersion = pi . versionName; 

} 

catch (Throwable throwable) { 

Log. e (tag, "Unable to ...", throwable); 

} 

Log.d(tag, progName + "/" + progVersion); 

} 



L_ 



: 



0); 
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Debug View 



P Debug - Sequence/src/corri/monead/ganies/android/sequerice/Seqyence.java - Eclipse SDK 



File Edit Run Source Navigate Search Project Ref actor Window Help 



m j$ $ i ^ - o - % - i»y* i^^Hffl ifi'S^O'O- 



t? 



Debug 



% as- dd 



W I 5. <5 .ift ^ I 5K 



a M 



Variables 



a, Sequence [Android Application] 
jf DalvikVM[localhost:8627] 

^ Thread [<1> main] (Running] 

[JS* Thread [<6> Binder Thread #2] (Running) 

[p Thread [<5> Binder Thread #1] (Running) 



Ej |fo Debug ] % J Java 

Breakpoints 



*£ B 



ffihelp.xml p Sequence Java * \ a AppView.java 

69 } 

70 

private void setup () { 
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Shar edPreferenr.es settinas = aet- 



J 



s Outline^ 






x • v 



' 



ccm.mcnead.games.android.sec ■* 
import declarations 
Sequence 

c£ F PREFERENCES_FILE_NAME : 
c£ F SERIALIZED.MODEL.FILE.IMj T 
m | t 



J 



■ Console «\-a Tasks 



cf @ - r3 - 



[2011-02-18 
[2011-02-18 
[2011-02-18 
[2011-02-18 



17 
17 
17 
17 



49: 
49 
49 
49 



37 
37 
40 
41 



Sequenc 
Sequenc 
Sequenc 
Sequenc 



' 



: 




®®©©©l + if-l« 



Message 

Precision (0.0,0.0) 
Raw (73,460) 
IY (73,410) 
Precision (0.0,0.0) 
Raw (73,460) 



□ 
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Launching Sequence 
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Log Entries 



yy *w w y»p ^& | 



I? 



I ^ 



tag 

System. . out 

System. . out 

com . monead . games . android . 

com . monead . games . android . 

Act ivi ty Manager 

KeyguardViewMediator 

Act ivi ty Manager 

ARM Assemb 1 er 

ARMAssembler 

com . monead . games . android . 

com . monead . games . android . 

com . monead . games . android . 

com . monead . games . android . 

com . monead . games . android . 

com . monead . games . android . 

com . monead . games . android . 

com . monead . games . android . 



sequence . Sequence 
sequence . Sequence 



sequence 
sequence 
sequence 
sequence 
sequence 
sequence 
sequence 
sequence 



Sequence 
Sequence 
Sequence 
Sequence 
Sequence 
Sequence 
Sequence 
Sequence 



Message 

waiting for debugger to settle. . . 

debugger has settled (1404) 

setup loading hard mode preference 

setup loading program name and version namel 

Displayed activity com . android . launcher/coml 

poke Wake lock ( E ) 

Displayed activity com . monead . games . androidl 

generated scanl ine 0000077:0354540 4_0 ol 

generated scanl ine 0000177:0351510 4_0 1| 

XY (34,409) 
Precision (0.0,0.0) 
Raw (34,459) 
XY (34,409) 
Precision (0.0,0.0) 
Raw (34,459) 
XY (73,410) 
Precision (0.0,0.0) 
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Android App Store 



k. 



Must create an Android Developer Account 

- $25 one-time fee 

- Create public/private key to sign all of your 

applications 

To sell your application must also create a 
Google Merchant Account 

- SSN/Tax Id 

- Fee schedule $0.30 + 2.9% down to 1.9% 

based on monthly sales $ 



<v 
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Assets for An Application 



k. 



Screenshots 
High-res Icon 

Promotional icons and videos 
Title and description 

- Internationalization supported 

Application type and category 

- e.g. Games, Brain&Puzzle 



^ 
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Build the Release 



Use the ant "release" task 

- Compiles, aligns (Dalvik VM, remember?) 

and signs (with your private key) 

Upload to the Android Market using your 
account 

- https://market.android.com/publish/Home 

Add release notes and publish 



k. 
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Variety of Market Statistics 



Device 



Others 




Country 



Others 




k. 



Motorola DroidX 
Samsung Galaxy Tab 

HTCDroid Incredible 
- Samsung Galaxy S 

HTC Desire HD 

HTC Wildfire 

HTC Evd AG 

LG Optimus One 



com. in on ead, games, android, sequence 
O Motorola DroitfX 7.1% [22) 



-United States 



Samsung Galaxy 
Tab 


6.8% [21) 


© HTCDroid 
Incredible 


5.1% (16) 


O Samsung Galaxy S 
[GT-I90QQ) 


5.1% (16) 


HTC Desire HD 


5.1% [16) 


© HTC Wildfire 


3.9% [12) 


HTC Evo 4G 


3.9% [12) 


LG Optimus One 


3,2% [10) 


Samsung Galaxy S 
(SCH-I500) 


2.9% [9) 


(E Motorola Droid 


2.6% [8) 



com. moneadgames.android. sequence 


Market all apps 


O United States 


55.6% (173) 


United States 


57.1% 


© United Kingdom 


5,8% [18) 


South Korea 


9.7% 


Canada 


2.9% [9) 


Japan 


6.4% 


Italy 


2.9% [9) 


United Kingdom 


4.3% 


Australia 


2.6% [3) 


France 


2.7% 


Brazil 


1.9% [6) 


Germany 


2.5% 


Mm fSprmanv 


1 q»4, ffiV 


Taiwan 


1 1% 



E 
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Our Journey? 

Scope and Preconditions 
Project: Directories and Files 
Activity LifecycleBB i 

Lifecycle Methods 

UlTnpift * * 

State 

Testing and Debugging 

Q&A_ 
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Go Forth and Code 



k. 



Thank you for attending! 

Download software and start developing 
- developer.android.com 

Tons of online support and articles 
Questions and pointers appreciated 
www.monead.com 

David.S.Read@gmail.com 
https://github.com/DaveRead/SequenceHunt 



^ 
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